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INTRODUCTION 


COMPRESS і5 a North Star single/double density, single disk-based utility program 
which permits significant shortening (in both size and execution time) of BASIC 
programs. With COMPRESS unnecessary spaces may be removed from any program, 
regardless of size. In addition, remark statements may either be retained or 
removed at the user's option. 


COMPRESS does not concatenate statement lines. There were several compelling 
reasons for not including this feature. First and foremost is the prohibitive 
amount of memory needed by utility programs which do contain such a feature. 
Because extensive GOTO and GOSUB tables must be established and cross referenced, 
such an option requires a large amount of RAM memory for processing. Іп Расі, 
DYNACOMP originally prepared COMPRESS for internal applications because it found 
commercially available programs to generally require more memory than physically 
possible in a standard North Star disk-based unit (greater than 57K) in order to 
process programs in excess of 18K bytes. | 


Second, the execution times of the commercially available programs are very long 
and the subsequent savings small. For example, our general observation has been 
that most of the reduction (“20 - 50%) in program size and execution speed is 
obtained through space and remark removal. A further small savings (5 - 15%) is 
possible through line concatenation. The execution speed gains are in similar, 
though usually lower proportions. 


COMPRESS directly operates on the BASIC file as it exists on the diskette. The 
original program is scanned line by line, and a separate and compressed program 
correspondingly written. Even a program which is too large to be loaded can be 
processed by COMPRESS and possibly reduced to a loadable size. 


COMPRESS is supplied in three forms on the user diskette. The first and longest 
version is uncompressed and internally documented for those interested in under- 
standing how this program operates. The second version is the result of using 
COMPRESS upon itself. The third version includes line concatenation to demonstrate 
the marginal improvement related to that feature. The first version is easily 
readable, the second difficult to follow, and the third impossible! 


OPERATION 
COMPRESS is very easy to use, as may be seen from the attached example. 


The first step in the procedure is to create two disk files of equal length which 
are at least as long as the program to be compressed. This is most easily done by 
twice NSAVEing the program to be compressed, using two different file names. Next 
the file types must be changed from "2" (BASIC file) to "3" (DATA file). This is 
most easily done by leaving BASIC with a BYE, changing both types with the DOS TY 
command, and returning (e.g., JP 2A04) to BASIC. Next load COMPRESS and RUN. 
COMPRESS expects one of these files to contain the target program. 
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One of the files will not be altered and must contain your program, whereas the 
other will be overwritten with the compressed program. When COMPRESS is executed, 
it will ask you which is which. COMPRESS will also give you the option of removing 
remark statements. 


When COMPRESS finishes, it will inform you how much compression was achieved. You 
may then convert both files back to type "2" by returning to the DOS (BYE) and 
again using the TY command. 


The above description, along with the attached example should make this procedure 
very clear. 


It is DYNACOMP's policy to support its software as much as possible. If you ex- 
perience any difficulties in using COMPRESS, or have any recommendations for improve- 
ment, please feel free to contact DYNACOMP. 





LOAD NOTES 


READY 
RUN 


NOTES FOR OPERATING COMPRESS 


THERE ARE THREE VERSIONS OF THE 
NORTH STAR BASIC COMPRESSION 
PROGRAM PRESENTED ON THIS DISK. 
THEY ALL DO THE SAME JOB» BUT 
ARE THEMSELVES COMPRESSED AND 
COMPACTED TO SOME DEGREE. 


‘COMPRESS’ IS THE ORIGINAL PROGRAM | 


”COMPRES1' IS THE RESULT OF USING 
“COMPRESS” IN ITSELF. “COMPRES2' 
IS THE RESULT OF FURTHER 
COMPACTION BY CONCATENATING 

LINES WHERE POSSIBLE. ’COMPRES2’ 
IS THE SHORTEST AND FASTEST 
RUNNING OF THE THREE VERSIONS. 


USING THE COMPRESSION PROGRAM IS 
VERY SIMPLE. TWO FILES ARE 
CREATED» ONE CONTAINING THE 
PROGRAM TO BE COMPACTED» AND ONE 
BEING THE DESTINATION OF THE 
COMPACTED FILE. BEFORE EXECUTION 
THE “TYPE” OF EACH FILE SHOULD 
BE CHANGED TO 3 AND THE DISKETTE 
UNPROTECTED. AFTER EXECUTION 

THE “TYPES” OF BOTH FILES SHOULD 
BE SET TO 2. BECAUSE THE 

PROGRAM ACTS ON ONE PROGRAM LINE 
AT A TIME» ÁNY SIZE PROGRAM MAY 
BE СОМРАСТЕП; EVEN ONE THAT 
COULD NOT BE LOADED BEFORE 
COMPRESSION! 


THE COMPRESSION PROGRAM REMOVES 
REMARK STATEMENTS AND BLANKS. 

IT DOES NOT CONCATENATE LINES. 
THE CONCATENATION FUNCTION 

WAS CONSIDEREDs BUT NOT INCLUDED 
SINCE MOST OF THE REDUCTION IN 
PROGRAM SIZE CAN BE ATTAINED 

(ТМ MOST CASES) BY REM AND 

BLANK REMOVAL. INCLUDING THE 
CONCATENATION FEATURE WOULD HAVE 
LEAD TO A VERY SLOWLY EXECUTING 
PROGRAM. 


THIS PROGRAM HAS BEEN USED 
EXTENSIVELY TO COMPRESS PROGRAMS 
FOR COMMERCIAL USE. IT IS 
BELIEVED TO BE RELIABLE. IF 
ERRORS DO OCCUR» PLEASE NOTIFY 
US. 


SAMPLE RUN OF COMPRESS 


AE ANA PAS 


There are three versions on disk: 


LOAD COMPRESS COMPRESS - highly commented 
N COMPRES] = COMPRESS used on Itself 
XTY COMPRESS 3 COMPRES2 - very compacted version 
ЖТУ СОМРКЕЗ1 3 In this sample run COMPRESS Is used on 
*JP 2A04 Е itself to create COMPRES], 
READY _ 
RUN Note that a file, COMPRESI, was created 
prior to this run, It is of the 
NORTH STAR BASIC FILE COMPRESSION PROGRAM same length in blocks as Compress, 
VERSION NSCM2.0 Both files are set to type 3 as 


required by the routine. 
COPYRIGHT 1979 BY 
DYNACOMP 
6 RIFPINGALE RD. 
PITTSFORD» NEW YORK 


THIS PROGRAM COMPACTS BASIC FILES BY 
OPTIONALLY REMOVING REMARK STATEMENTS 
AND DELETING UNNECESSARY SPACES. ANY 
SIZE FILE MAY BE COMPRESSED GIVEN 
ENOUGH DISK SPACE. 


WARNING? THE SOURCE AND DESTINATION FILES If this Is not done, the program 
MUST BE OF TYPE 3. CHANGE THE TYPE IN will fail with a file error message, 
THE DOS AND THEN CONTINUE. 

NOTE ALSO THAT THIS PROGRAM MUST BE COMPRESS requires byte-wfise access 
RUN USING RELEASE 4 OR HIGHER NORTH to the disk Ее. 


STAR BASIC AND DOS. 


INPUT THE NAME OF THE FILE TO 





BE COMPRESSED: ?COMFRESS COMPRESS js now the source file, and 

INPUT NAME OF COMFRESSED FILE !?COMPRES1 COMPRESI the destination, or 'target', 

DO YOU WISH TO REMOVE REMARKS (Y/N)? TY If 'N', then only the spaces will be 
removed, 

COMPRESSED FILE SIZE! 1676 BYTES After some time and several disk 1/0's, 
this message will appear, 

FILE COMPRESSION ACHIEVED: „441 COMPRESS was highly commented, Therefore 


a very high compression was achieved, 
Note - the new file, COMPRES], Is only 
READY LL% of the size of COMPRESS, COMPRES] 

may be compacted an additional 16% by line concatenation. 
Observe that this additional savings Is only 7% relative 
to the original file, COMPRESS, In this case removing 
spaces and REMs was six time more effective than 11пе 
concatenation, 


After the file compression has be finished, change the 
files back to type 2, 


